dotnetCHARTING Send comments on this topic.
CFrequencyTableBOL(Series,Double[]) Method
See Also 
dotnetCHARTING Namespace > StatisticalEngine Class > CFrequencyTableBOL Method : CFrequencyTableBOL(Series,Double[]) Method


s
A statistical series.
boundaries
A strictly increasing sequence of boundaries of the intervals over the real line in which the data sets point will be assigned.
Calculates the cumulative frequency table from below for a discrete data set in accordance with the open left boundary (OLB) convention.

Syntax

Visual Basic (Declaration) 
Public Overloads Shared Function CFrequencyTableBOL( _
   ByVal s As Series, _
   ByVal boundaries() As Double _
) As Series
Visual Basic (Usage)Copy Code
Dim s As Series
Dim boundaries() As Double
Dim value As Series
 
value = StatisticalEngine.CFrequencyTableBOL(s, boundaries)
C# 
public static Series CFrequencyTableBOL( 
   Series s,
   double[] boundaries
)

Parameters

s
A statistical series.
boundaries
A strictly increasing sequence of boundaries of the intervals over the real line in which the data sets point will be assigned.

Exceptions

ExceptionDescription
ArgumentExceptionThrown if the input data are not given.
ArgumentExceptionThrown if data set or the boundaries intervals are null.

Remarks

The value of the cumulative frequency table values at a given point is the number of elements within the data set below the highest value of that interval of the frequency table constructed in accordance with the open left boundary convention.

Example

Within this example we work through an illustration in which the cumulative frequency table from below using the open left boundary convention is evaluated.

Consider the set of boundaries { 1, 2, 3, 4, 5 }, which divide the real line into six sub-intervals. Now if we use the open left boundary convention then the real line will be divided into the sub-intervals:

(-infinity, 1], (1,2], (2,3], (3,4], (4,5], (5, infinity)

Note that, each point on the real line can be assigned to one of these sub-intervals and therefore when assigning a data point to one of these intervals there will only be one sub-interval in which it belongs.

Therefore, if we consider the data set { 0.5, 1.4, 1.3, 2.0, 2.3, 4.5, 5.5}, if the assign this data set in accordance with the above the conventions then we will have: using Open Left Boundary (OLB) convention:

  • Within the interval (-infinity, 1], we assign the data element 0.5; and hence the frequency of this interval is 1.
  • Within the interval (1, 2], we assign the data element 1.4, 1.3, 2.0; and hence the frequency of this interval (wrt OLB convention) is 3.
  • Within the interval (2, 3], we assign the data element 2.3, and hence the frequency of this interval (wrt OLB convention) is 1.
  • Within the interval (3, 4], we assign no data elements, and hence the frequency of this interval (wrt OLB convention) is 0.
  • Within the interval (4, 5], we assign the data element 4.5, and hence the frequency of this interval (wrt OLB convention) is 1.
  • Within the interval (5, infinity), we assign the data element 5.5, and hence the frequency of this interval (wrt OLB convention) is 1.

Now in follows that the associated values of the cumulative frequency table are given by:

  • Cumulative frequency table up to 1 is: 1
  • Cumulative frequency table up to 2 is: 4
  • Cumulative frequency table up to 3 is: 5
  • Cumulative frequency table up to 4 is: 5
  • Cumulative frequency table up to 5 is: 6
  • Cumulative frequency table up to 5 is: 7

Hence, for this case the series returned by this methods to represent the cumulative frequency table would be: {1, 4, 5, 5, 6, 7}.

See Also

© 2010 All Rights Reserved.